home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Graphics / SMan / WarpOS / ReadMe.First < prev    next >
Encoding:
Text File  |  2001-03-28  |  4.7 KB  |  108 lines
  1. I gave up waiting for a G4 card and finally got a replacement for my dead
  2. CSPPC card.  Now I'm updating some of my previous work.
  3.  
  4. Note that the current development has been done under AmigaOS 3.9, and
  5. WarpOS version 16 of the PowerPC.library (version 5.0 of Warp.library).
  6. I haven't tested this under earlier versions, but don't believe I've
  7. made any changes that would cause a failure under earlier systems.
  8.  
  9.  
  10. This archive SManWOSB2.lha contains the following files:
  11.  
  12. 1)    This ReadMe.First file
  13. 2)    SMan.guide  (It hasn't been revised and may not be accurate.)
  14. 3)    SManWOS and SManWOS.info
  15.  
  16. In the Source directory
  17. 4)    SManWOS.c
  18. 5)    Packer.c
  19. 6)    Save.c
  20. 7)    LUP2.c   (C source for the algorithm than handles fractional powers,
  21.       and powers greater than 7.
  22. 8)    ULP2.asm - ULP7.asm (asm source for the Mandelbrot algorithm, that
  23.       decides on the pixel color)
  24. 9)    LinkWOS     Used instead of a makefile.
  25.  
  26. The following in the Source directory are not actually used in this release,
  27. but were part of the development process.
  28.  
  29. 10)   ULP2.c      Handled the n = 2 part of the Mandelbrot algorithm.
  30. 11)   ULP2.asm.org      The output of vbcc from ULP2.c
  31. 12)   UseLib.c    Not actually used in this version, but was a part of
  32.       earlier versions.  It has been used as a model for ULP3.asm through
  33.       ULP7.asm.
  34.  
  35. The source directory has only been included for educational purposes.
  36.  
  37.  
  38. Note that this is my second release of anything that runs under WarpOS.
  39. Note also that I've been using vbcc for the WarpOS version of SMan.
  40. Save.c (and possibly Packer.c) contains includes probably not in the
  41. standard include:, which was from Sas version 6.58 for me.
  42.  
  43.  
  44. My special thanks to the following people/companies that have made this
  45. possible:
  46.  
  47.  
  48.       Phase 5 for having designed the CyberStormPPC that I'm using in this
  49.       development (and DCE for making the replacement card).  We need
  50.       companies to continue with hardware manufacture for the Amiga.
  51.  
  52.       Sam Jordan from Haage and Partners for WarpOS, not to mention all
  53.       the useful programming hints he's provided for developers along with
  54.       the release of WarpOS.
  55.  
  56.       Frank Wille for the release of the WarpOS versions of vbcc, and his
  57.       help in the details of linking assembler code with C code using it.
  58.  
  59.       Note that before starting on the conversion for SMan to WarpOS, I'd
  60.       never done any assembler programming for the PowerPC chip.  My work
  61.       on this was done by starting with the asm code generated by vbcc and
  62.       editing it to work more efficiently than that generated by vbcc.
  63.       This has provided a significant, although not overwhelming
  64.       improvement in speed.  That is, image generation is typically
  65.       between 3 and 4 times as fast with the tweaked assembler code, as
  66.       otherwise.  This may still not be as fast as Cybermand(I assume by
  67.       Sam Jordan, or his colleagues), but is reasonably fast, and should
  68.       work on the Workbench with any color depth.  I don't have an AGA
  69.       Amiga and don't know about whether it works in that mode, but it does
  70.       work in any CyberGraphX mode, and even works with 16 color NTSC High
  71.       Res Laced.  I wouldn't recommend that though, as it's so much slower
  72.       than CyberGraphX, not to mention the limitation in colors.
  73.       Futhermore, it's limited to one palette, and a rather poor one at
  74.       that.
  75.  
  76.       The assembler work has been extended to include z^n + z -> z for
  77.       n < 8 algorithms.  LUP2.c has not been converted, as the biggest
  78.       slow-down is with the transcendental functions (primarily arctan), and
  79.       it's unlikely that I could improve that significantly over the ppcmath
  80.       library.
  81.  
  82.       Note that I'd also like to thank CyberGraphX, and especially Frank
  83.       Mariak, who has always been helpful in answering questions about
  84.       CyberGraphics. Note that a MorphOS version will be forthcoming
  85.       shortly.  Frank Mariak is one of those working on that project.
  86.  
  87.       Note that when using a Workbench with a CyberGraphX screen of more
  88.       than 8 bit depth, the image is displayed only when the complete image
  89.       has been generated within a buffer, whereas with a depth of 8 or less,
  90.       the image is updated at the end of each scan line within the window.
  91.       In the former case, the function WritePixelArray is used to display
  92.       the image, and in the latter, WritePixelLine8 is used.
  93.  
  94.       Please tell me whether or not SManWOSB2 works on your system.
  95.       I would be interested as to whether it works on other PowerPC cards
  96.       than those by Phase 5 as well.
  97.  
  98. Note that all timing for the generation of the image is only for processing
  99. time, and not display time.
  100.  
  101.  
  102.  
  103.       E-mail to me (dmckinstry@ewu.edu) any reports, questions, etc.
  104.  
  105.       Thanks,
  106.  
  107.       Dave McKinstry
  108.